package com.nidu.demo.file.api;

import com.alibaba.cola.dto.PageResponse;
import com.alibaba.cola.dto.Response;
import com.alibaba.cola.dto.SingleResponse;
import com.nidu.demo.file.dto.*;
import org.springframework.web.multipart.MultipartFile;

import java.util.Set;

/**
 * 文件服务接口
 *
 * @author auto
 */
public interface SysFileService {

    /**
     * 上传文件
     *
     * @param file 文件
     * @param module 模块名称
     * @return 文件信息
     */
    SingleResponse<FileCO> uploadFile(MultipartFile file, String module);

    /**
     * 上传文件（指定存储类型）
     *
     * @param file 文件
     * @param module 模块名称
     * @param storageType 存储类型
     * @return 文件信息
     */
    SingleResponse<FileCO> uploadFile(MultipartFile file, String module, Integer storageType);

    /**
     * 删除文件
     *
     * @param id 文件ID
     * @return 操作结果
     */
    Response delete(Long id);

    /**
     * 批量删除文件
     *
     * @param ids 文件ID列表
     * @return 操作结果
     */
    Response delete(Set<Long> ids);

    /**
     * 获取文件详情
     *
     * @param id 文件ID
     * @return 文件详情
     */
    SingleResponse<FileCO> getById(Long id);

    /**
     * 分页查询文件
     *
     * @param qry 分页查询条件
     * @return 分页结果
     */
    PageResponse<FileCO> page(FilePageQry qry);
}